package com.example.shuiyin.service;

import com.example.shuiyin.dto.PlanDto;
import com.example.shuiyin.dto.SubscribeRequest;
import com.example.shuiyin.dto.SubscriptionStatusDto;

import java.util.List;

/**
 * 订阅服务
 */
public interface SubscriptionService {

    /**
     * 获取可用套餐列表
     */
    List<PlanDto> getAvailablePlans();

    /**
     * 订阅套餐
     */
    String subscribe(Long userId, SubscribeRequest request);

    /**
     * 获取订阅状态
     */
    SubscriptionStatusDto getSubscriptionStatus(Long userId);

    /**
     * 取消订阅
     */
    void cancelSubscription(Long userId);

    /**
     * 激活订阅
     */
    void activateSubscription(Long userId, String planId, String orderId, String billingCycle);

    /**
     * 检查用户是否有有效的订阅
     */
    boolean hasActiveSubscription(Long userId);

    /**
     * 检查用户是否超出配额
     */
    boolean isQuotaExceeded(Long userId);

    /**
     * 更新用户使用配额
     */
    void updateUsageQuota(Long userId, int amount);
} 